home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 19.zip / BS1 part 19 / PD 3.adf / Drw / drw.doc < prev    next >
Text File  |  1986-11-20  |  8KB  |  153 lines
  1.      Some spotty documentation for the DRW program
  2.  
  3.  
  4. Introduction:
  5.    DRW is a sonic spectrum editor. It allows you to paint a sonogram
  6. using specialized 'brushes' and then synthesize the corresponding 
  7. audio waveform. The program presents you with a grey area where
  8. time is on the x-axis, frequency (actually phase increment) is on the
  9. y-axis and color represents the amplitude of the sinewave at that point
  10. in time and phase. Sonograms may be loaded and stored, sound files
  11. may be analyzed into sonograms and resulting sounds may be saved as 
  12. IFF 8SVX files. It allows you to play the sound (both channels) with the
  13. mouse controlling frequency.
  14.  
  15. Caution:
  16.    This is an extremely quick and dirty program which reads the color
  17.  values directly off the screen. There is no 'UNDO'. Because it is
  18. written in CSI Multi-forth, certain operations are slower than they
  19. need to be.  Filename handling may be unfriendly should you make a
  20. typo or two. There are several other annoying things  that I won't
  21. mention.
  22.  
  23.   The Screen:
  24. The screen presents a 128 by 256 pixel drawing area, surmounted by
  25. a color palette of 30 colors, ranging from grey(0) through blue, black,
  26. red, orange and yellow(255). Beneath the palette is the control comb,
  27. which selects various brushes and drawing options. On the right is a
  28. pathetic pseudo-prop gadget which controls certain drawing characteristics.
  29.   
  30.   The MODES:
  31. There are several states into which the program may be put: all of them are
  32. accessed via the keyboard buttons. They are:
  33.  T)op D)oodle S)ynth P)lay R)eset  W)rite B)andpass I)input O)utput Q)uit
  34.  
  35.  T)op mode: clears the screen to grey ( amplitude 0), then goes directly to    
  36. D)oodle mode.
  37.  
  38.  D)oodle mode is the main drawing mode. It works with the comb to allow
  39. the sonogram to be drawn. To use the comb, you click on one of the tines.
  40. A user-unfriendly 4 letter  mnemonic appears on the right of the screen, 
  41. along with its corresponding number .
  42.  
  43.  Here are the various options which this enables:
  44. 1) Dot  A dot of the selected color is continuously dropped on
  45.         the screen  while the left mouse button is depressed.
  46. 2) Line A continuous line is drawn while the button is down. Note that
  47.         the line cannot be drawn from right to left.. to encourage
  48.         'proper temporal flow'.
  49. 3) Ramp A line at this frequency is 'ramped' up to the selected color,
  50.         and then ramped down. The rate of ramping is controlled by the
  51.         phony prop gadget. The ramp is summed into the color on the
  52.         screen.
  53. 4) Thin A thin Rectangle is deposited, much as a dot is.
  54. 5) Blob A rather fat rectangle is deposited.
  55. 6) Harm A ramp in the suitable color and rate is summed into the screen
  56.         at harmonics determined by the current Frequency space settings.
  57.         The Pointer represents the eighth harmonic. Only writes forward, 
  58.         and connects points continuously. This is is admittedly slower than 
  59.         it could be. Harm can be used to create a harmonic framework for
  60.         subsequent   alterations.
  61. 7) Avg  Averages a few pixels before and after the pointer for this
  62.         frequency.
  63. 8) R-Dn Ramps down from the color under the pointer, using the rate from
  64.         the prop gadget.
  65. 9) R-Up Ramps up (backwards) from the pointer position, like ramp down.
  66. 10) Fill Fills this frequency with this color, until it hits a color
  67.          differing from that under the pointer.
  68. 11) Fil2 Tries to do a ramp-fill up to the selected color to the colors
  69.          at the edges. Doesn't work.
  70. 12) Inc Adds one to the spot under the pointer. GOes forward.
  71. 13) Dec Decrements this spot by one.
  72. 14) Xcld Excludes all but harmonics at this time period. The pointer
  73.          represents the eighth harmonic.
  74. 15) -Cut removes all colors quieter than the current one from the 
  75.          sonogram. Nice for cleaning BPFs. 
  76. 16) Inc0 Increments if there is a non-grey color under the pointer. For
  77.          making soft areas louder.
  78. 17) Dec0 Decrement, but not down to grey - just to green.
  79. 18) From sets the 'from' point for a Copy. You must click the left button.
  80. 19) To   sets the 'to' spot for a copy.
  81. 20) Copy Copies 'pantograph'-style for those of you who remember Images,
  82.          based on the 'from area' going to the 'to' area.
  83. 21) .21. nothing
  84. 22) AMmd Puts some AM sin-waves on the screen as raw material.
  85. 23) CpFr Copies a frequency line to new Mouse's freq. Uses From.
  86. 24) CpTm Copies a time slot to new Mouse's slot. ditto.
  87. 25) Lck1 Puts a  lock on every frequency. A harmonic lock crudely constrains
  88.          certain brushes from being positioned anywhere but on the nth line.
  89.          Allows stable  harmonic timbres to be easily created for use
  90.          as loops.
  91. 26) Lck2 Locks even lines.
  92. 27) Lck4 Locks every 4th line.
  93. 28) Lck8 Locks every 8th line.
  94. 29) Vl00 restores original amplitude boost.
  95. 30) Vl01 doubles amplitude when Synthing the sample.
  96.  
  97. S)ynth zero's the sound area and then creates the waveform by additive
  98. synthesis. You may cut the sound short by typing 'P' to go directly to
  99. play mode. This may be slow at times, but it depends on the current 
  100. time and frequency settings. Technicians will note that I am using
  101. fixed point arithmetic and a custom sin-lookup table to make this
  102. calculation.
  103.   
  104. P) Play plays the sound area. Moving the mouse vertically changes the
  105. Amiga 'period' (i.e. frequency.)
  106.  
  107. The following modes require some names and1 ,   \ 50
  108. 41CE , 427A , 4326 , 43D1 , 447B , 4524 , 45CD , 4675 ,   \ 58
  109. 471D , 47C4 , 486A , 490F , 49B4 , 4A58 , 4AFB , 4B9E ,   \ 60
  110. 4C40 , 4CE1 , 4D81 , 4E21 , 4EC0 , 4F5E , 4FFB , 5098 ,   \ 68
  111. 5134 , 51CF , 5269 , 5303 , 539B , 5433 , 54CA , 5560 ,   \ 70
  112. 55F6 , 568A , 571E , 57B1 , 5843 , 58D4 , 5964 , 59F4 ,   \ 78
  113. 5A82 , 5B10 , 5B9D , 5C29 , 5CB4 , 5D3E , 5DC8 , 5E50 ,   \ 80
  114. 5ED7 , 5F5E , 5FE4 , 6068 , 60EC , 616F , 61F1 , 6272 ,   \ 88
  115. 62F2 , 6371 , 63EF , 646C , 64E9 , 6564 , 65DE , 6657 ,   \ 90
  116. 66D0 , 6747 , 67BD , 6832 , 68A7 , 691A , 698C , 69FD ,   \ 98
  117. 6A6E , 6ADD , 6B4B , 6BB8 , 6C24 , 6C8F , 6CF9 , 6D62 ,   \ A0
  118. 6DCA , 6E31 , 6E97 , 6EFB , 6F5F , 6FC2 , 7023 , 7083 ,   \ A8
  119. 70E3 , 7141 , 719E , 71FA , 7255 , 72AF , 7308 , 735F ,   \ B0
  120. 73B6 , 740B , 7460 , 74B3 , 7505 , 7556 , 75A6 , 75F4 ,   \ B8
  121. 7642 , 768E , 76D9 , 7723 , 776C , 77B4 , 77FB , 7840 ,   \ C0
  122. 7885 , 78C8 , 790A , 794A , 798A , 79C9 , 7A06 , 7A42 ,   \ C8
  123. 7A7D , 7AB7 , 7AEF , 7B27 , 7B5D , 7B92 , 7BC6 , 7BF9 ,   \ D0
  124. 7C2A , 7C5A , 7C89 , 7CB7 , 7CE4 , 7D0F , 7D3A , 7D63 ,   \ D8
  125. 7D8A , 7DB1 , 7DD6 , 7DFB , 7E1E , 7E3F , 7E60 , 7E7F ,   \ E0
  126. 7E9D , 7EBA , 7ED6 , 7EF0 , 7F0A , 7F22 , 7F38 , 7F4E ,   \ E8
  127. 7F62 , 7F75 , 7F87 , 7F98 , 7FA7 , 7FB5 , 7FC2 , 7FCE ,   \ F0
  128. 7FD9 , 7FE2 , 7FEA , 7FF1 , 7FF6 , 7FFA , 7FFE , 7FFF ,   \ F8
  129. 8000 , 7FFF , 7FFE , 7FFA , 7FF6 , 7FF1 , 7FEA , 7FE2 ,   \ 100
  130. 7FD9 , 7FCE , 7FC2 , 7FB5 , 7FA7 , 7F98 , 7F87 , 7F75 ,   \ 108
  131. 7F62 , 7F4E , 7F38 , 7F22 , 7F0A , 7EF0 , 7ED6 , 7EBA ,   \ 110
  132. 7E9D , 7E7F , 7E60 , 7E3F , 7E1E , 7DFB , 7DD6 , 7DB1 ,   \ 118
  133. 7D8A , 7D63 , 7D3A , 7D0F , 7CE4 , 7CB7 , 7C89 , 7C5A ,   \ 120
  134. 7C2A , 7BF9 , 7BC6 , 7B92 , 7B5D , 7B27 , 7AEF , 7AB7 ,   \ 128
  135. 7A7D , 7A42 , 7A06 , 79C9 , 798A , 794A , 790A , 78C8 ,   \ 130
  136. 7885 , 7840 , 77FB , 77B4 , 776C , 7723 , 76D9 , 768E ,   \ 138
  137. 7642 , 75F4 , 75A6 , 7556 , 7505 , 74B3 , 7460 , 740B ,   \ 140
  138. 73B6 , 735F , 7308 , 72AF , 7255 , 71FA , 719E , 7141 ,   \ 148
  139. 70E3 , 7083 , 7023 , 6FC2 , 6F5F , 6EFB , 6E97 , 6E31 ,   \ 150
  140. 6DCA , 6D62 , 6CF9 , 6C8F , 6C24 , 6BB8 , 6B4B , 6ADD ,   \ 158
  141. 6A6E , 69FD , 698C , 691A , 68A7 , 6832 , 67BD , 6747 ,   \ 160
  142. 66D0 , 6657 , 65DE , 6564 , 64E9 , 646C , 63EF , 6371 ,   \ 168
  143. 62F2 , 6272 , 61F1 , 616F , 60EC , 6068 , 5FE4 , 5F5E ,   \ 170
  144. 5ED7 , 5E50 , 5DC8 , 5D3E , 5CB4 , 5C29 , 5B9D , 5B10 ,   \ 178
  145. 5A82 , 59F4 , 5964 , 58D4 , 5843 , 57B1 , 571E , 568A ,   \ 180
  146. 55F6 , 5560 , 54CA , 5433 , 539B , 5303 , 5269 , 51CF ,   \ 188
  147. 5134 , 5098 , 4FFB , 4F5E , 4EC0 , 4E21 , 4D81 , 4CE1 ,   \ 190
  148. 4C40 , 4B9E , 4AFB , 4A58 , 49B4 , 490F , 486A , 47C4 ,   \ 198
  149. 471D , 4675 , 45CD , 4524 , 447B , 43D1 , 4326 , 427A ,   \ 1A0
  150. 41CE , 4121 , 4074 , 3FC6 , 3F17 , 3E68 , 3DB8 , 3D08 ,   \ 1A8
  151. 3C57 , 3BA5 , 3AF3 , 3A40 , 398D , 38D9 , 3825 , 3770 ,   \ 1B0
  152. 36BA , 3604 , 354E , 3497 , 33DF , 3327 , 326E , 31B5 ,   \ 1B8
  153. 30FC , 3042 , 2F87 , 2ECC , 2E11 ,